home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / divo_ee.z / divo_ee
Encoding:
Text File  |  2002-10-03  |  6.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ddddiiiivvvvoooo____eeeeeeee((((1111))))                                                          ddddiiiivvvvoooo____eeeeeeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      divo_ee - DIVO Video end-to-end program
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      divo_ee [-a <frame-count>] [-c <numframes>] [-f] [-h] [-n <devicenum>]
  14.              [-p <packing>] [-q] [-s <colorspace>] [-v] [-w <fname>]
  15.              [-F <format>] [-P <precision>] [-S <sampling>] [-T <timing>]
  16.  
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _d_i_v_o__e_e demonstrates copying video data from the input of a DIVO device
  20.      to its output, in a variety of modes.  It sets up two paths, one from the
  21.      video soure to memory and the other from memory to the video drain.  The
  22.      program is intended to be used as a system verification tool.  It allows
  23.      easy testing of the effects of various data packings and color-space
  24.      conversions.  _d_i_v_o__e_e is also useful for determining data rates or for
  25.      evaluating the compression achieved using the RICE coding system on a
  26.      particular video signal.
  27.  
  28.      _d_i_v_o__e_e has the following options:
  29.  
  30.  
  31.      ----hhhh   display a usage message.
  32.  
  33.      ----aaaa _f_r_a_m_e-_c_o_u_n_t
  34.           If this parameter is specified, _d_i_v_o__e_e will reset its bandwidth
  35.           calculation statistics every time _f_r_a_m_e-_c_o_u_n_t frames of video are
  36.           transferred.  If not specified, _d_i_v_o__e_e will never reset its
  37.           statistics and will therefore produce a long-term bandwidth
  38.           computation for its entire run.
  39.  
  40.      ----cccc _f_r_a_m_e-_c_o_u_n_t
  41.           If this parameter is specified, _d_i_v_o__e_e will exit after _f_r_a_m_e-_c_o_u_n_t
  42.           frames of video are transferred.  If not specified, _d_i_v_o__e_e will run
  43.           until it is killed or interrupted.
  44.  
  45.      ----ffff   use frame mode (_V_L__C_A_P_T_U_R_E__I_N_T_E_R_L_E_A_V_E_D).
  46.  
  47.      ----nnnn _d_e_v_i_c_e-_n_u_m_b_e_r
  48.           specifies the VL device number to use.  If not specified, the first
  49.           device will be used.
  50.  
  51.      ----pppp _p_a_c_k_i_n_g
  52.           This flag specifies the packing type to use at the memory interface
  53.           of each path.  The value of the _p_a_c_k_i_n_g flag may be specified as a
  54.           text name or a number.  Values are as defined by the video library.
  55.           The appropriate values are reported by the built-in help message in
  56.           _d_i_v_o__e_e or those reported by _v_l_i_n_f_o -_l.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddiiiivvvvoooo____eeeeeeee((((1111))))                                                          ddddiiiivvvvoooo____eeeeeeee((((1111))))
  71.  
  72.  
  73.  
  74.      ----qqqq   _Q_u_i_e_t the printed output of _d_i_v_o__e_e.  The default message level is
  75.           two.  Each invocation of the -_q parameter reduces it by one.  At
  76.           level zero, only critical messages are output.
  77.  
  78.      ----ssss _c_o_l_o_r_s_p_a_c_e
  79.           This flag specifies the colorspace type to use at the memory
  80.           interface of each path.  The value of the _c_o_l_o_r_s_p_a_c_e flag may be
  81.           specified as a text name or a number.  Values are as defined by the
  82.           video library.  The appropriate values are reported by the built-in
  83.           help message in _d_i_v_o__e_e or those reported by _v_l_i_n_f_o -_l.
  84.  
  85.      ----vvvv   Increase the _v_e_r_b_o_s_i_t_y of the printed output of _d_i_v_o__e_e.  The
  86.           default message level is two.  Each invocation of the -_v parameter
  87.           increases it by one.  At level four, all messages and events are
  88.           reported.
  89.  
  90.      ----wwww ffffiiiilllleeeennnnaaaammmmeeee
  91.           _w_r_i_t_e the first buffer to disk and exit.  This simple function
  92.           writes the very first buffer received from the input stream to disk.
  93.           The buffer is written in binary format with no file header.
  94.  
  95.      ----FFFF _f_o_r_m_a_t
  96.           If specified, the format of the video nodes will be set to _f_o_r_m_a_t.
  97.           If not specified, the current value as set by _v_c_p(_1) (a.k.a
  98.           _v_i_d_e_o_p_a_n_e_l(_1)) will be used. Please see the on-line help for
  99.           details.
  100.  
  101.      ----TTTT _t_i_m_i_n_g
  102.           If specified, the timing of the video nodes will be set to _t_i_m_i_n_g.
  103.           If not specified, the current value as set by _v_c_p(_1) (a.k.a
  104.           _v_i_d_e_o_p_a_n_e_l(_1)) for the video input will be used. The timing of the
  105.           video output is always set to match the video input.  Please see the
  106.           on-line help for details.
  107.  
  108.      ----PPPP _p_r_e_c_i_s_i_o_n
  109.           This switch enables Rice lossless compression, and specifies number
  110.           of bits per component of precision. Please see the on-line help for
  111.           details.
  112.  
  113.      ----SSSS _s_a_m_p_l_i_n_g
  114.           This switch enables Rice lossless compression, and specifies the
  115.           sampling rate of the color components. Please see the on-line help
  116.           for details.
  117.  
  118. FFFFIIIILLLLEEEESSSS
  119.      Source files:
  120.           /usr/share/src/dmedia/video/DIVO/divo_ee.C
  121.           /usr/share/src/dmedia/video/DIVO/divo_ee.h
  122.           /usr/share/src/dmedia/video/DIVO/divo_ee_args.C
  123.           /usr/share/src/dmedia/video/DIVO/divo_ee_events.C
  124.           /usr/share/src/dmedia/video/DIVO/divo_ee_paths.C
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ddddiiiivvvvoooo____eeeeeeee((((1111))))                                                          ddddiiiivvvvoooo____eeeeeeee((((1111))))
  137.  
  138.  
  139.  
  140. NNNNOOOOTTTTEEEESSSS
  141.      The source code to this program is in the _d_i_v_o._s_w._g_i_f_t_s subsystem.
  142.  
  143.  
  144. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  145.      divo(7), divo_memtovid(1), divo_vidtomem(1), vcp(1)
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.